home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / ccmdr_i.zip / CCI.DOC < prev    next >
Text File  |  1996-05-26  |  20KB  |  486 lines
  1.  
  2.  
  3.  
  4.                            ▄▄▄▄ ▄▄▄▄ ▄    ▄▄▄▄ ▄▄▄▄
  5.                            █    █  █ █    █  █ █▄▄█
  6.                            █▄▄▄ █▄▄█ █▄▄▄ █▄▄█ █ █▄
  7.                ▄▄▄▄ ▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄ ▄ ▄▄▄▄▄ ▄▄▄▄ ▄▄▄▄
  8.                █    █  █ █ █ █ █ █ █ █▄▄█ █ █ █  █  █ █▄   █▄▄█
  9.                █▄▄▄ █▄▄█ █ █ █ █ █ █ █  █ █ █▄█ ▄█▄▄█ █▄▄▄ █ █▄
  10.  
  11.                             I N T E R A C T I V E
  12.                ────────────────────────────────────────────────
  13.                         Copyright (c) 1994 Mike Laszko
  14.  
  15.  
  16.  
  17.             COLOR COMMANDER INTERACTIVE SHAREWARE SOFTWARE LICENSE
  18.             ──────────────────────────────────────────────────────
  19.          This version of Color Commander Interactive is NOT public domain
  20.          or free software, but is being distributed as "SHAREWARE" for
  21.          EVALUATION PURPOSES ONLY. Your use of this software indicates
  22.          your agreement to the terms and conditions of this License.
  23.  
  24.  
  25.                               USAGE RESTRICTIONS
  26.                               ──────────────────
  27.          The author and Data Management Systems grants a limited license to
  28.          individuals to use this shareware software for a 30-day evaluation
  29.          period on a private, non-commercial basis, for the express purpose
  30.          of determining whether Color Commander Interactive is suitable for
  31.          their needs. At the end of this 30-day evaluation period, the
  32.          individual must register the program or discontinue use.
  33.  
  34.          You may freely distribute the ShareWare version of Color Commander
  35.          Interactive and are encouraged to do so provided it is in its
  36.          original, unmodified form.
  37.  
  38.          This software and documentation is protected under the United States
  39.          Copyright Laws and International Treaty Provisions. Your support of
  40.          Shareware is appreciated.
  41.  
  42.  
  43.                                LIABILITY WAIVER
  44.                                ────────────────
  45.          COLOR COMMANDER INTERACTIVE IS LICENSED "AS-IS."  THE AUTHOR OR HIS
  46.          AGENTS MAKE NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT
  47.          TO THIS PROGRAM, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR
  48.          FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR
  49.          HIS AGENTS BE LIABLE FOR ANY CLAIMS FOR LOST PROFITS OR ANY DAMAGE,
  50.          INCLUDING, BUT NOT LIMITED TO, SPECIAL, INCIDENTAL, CONSEQUENTIAL
  51.          OR OTHER DAMAGE. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION
  52.          OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR
  53.          EXCLUSION MAY NOT APPLY TO YOU. IN NO CASE SHALL THE AUTHOR OR HIS
  54.          AGENTS' LIABILITY EXCEED THE LICENSE FEES PAID FOR THE RIGHT TO USE
  55.          THE LICENSED SOFTWARE.
  56.  
  57.  
  58.  
  59.                                       -1-
  60.  
  61.  
  62.  
  63.  
  64.          Color Commander Interactive is a DOS "TEXT" mode VGA/SVGA utility.
  65.          It is not intended for use under windows or any other graphical
  66.          user interface (GUI). It was written and tested on an SVGA system.
  67.          Use of Color Commander Interactive on a MONOCHROME, EGA or other
  68.          NON VGA/SVGA compatible system is not supported.
  69.  
  70.  
  71.  
  72.          What is Color Commander Interactive?
  73.  
  74.          Color Commander Interactive is a terminate and stay resident (TSR)
  75.          TEXT mode (non-graphics) utility that will enable you to change
  76.          any or all of the 16 DOS colors to any one of 262,144 colors from
  77.          within your favorite program. Color Commander Interactive accesses
  78.          the VGA DAC registers directly, bypassing normal color selecting
  79.          conventions.
  80.  
  81.          Color Commander Interactive will allow you to edit existing palettes
  82.          or create new ones. You can save the new palettes to disk as a .PAL
  83.          file which can be loaded into Color Commander Interactive later on,
  84.          or as a .COM file (REGISTERED version only) which when called will
  85.          set the VGA palette directly, without having to run Color Commander
  86.          Interactive first. The .COM file can be called from the DOS prompt
  87.          or from a batch file.
  88.  
  89.          Choosing softer, less glaring colors for your VGA palette will
  90.          reduce eye strain and create a more aesthetically pleasing
  91.          computing environment.
  92.  
  93.          Color Commander Interactive should never permanently change or
  94.          damage your VGA hardware. It simply temporarily reprograms the
  95.          color registers in your VGA card. When your system is rebooted
  96.          DOS sets the color registers in your VGA adapter to the DOS default
  97.          colors.
  98.  
  99.  
  100.  
  101.  
  102.          Text mode color under DOS:
  103.  
  104.          Under DOS each of the 16 colors that are available to your programs
  105.          are assigned a number of 0-15. Color 0 is black, color 1 is blue,
  106.          color 15 is white etc. When a program is running under DOS and it
  107.          wants to display a color, say blue for example, it selects color 1.
  108.          If you change blue to orange using Color Commander Interactive and
  109.          then run your program again, when it selects blue this time, it will
  110.          display orange instead. Your program never knows it is not displaying
  111.          blue because you have changed blue to orange at the hardware level.
  112.          Every instance of blue now becomes orange.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                       -2-
  119.  
  120.  
  121.  
  122.  
  123.          A graphics program like MS Windows will reset the VGA palette when
  124.          it is run. If a custom palette is active at this time it will be
  125.          reset. When the graphics program exits to DOS it sets the palette to
  126.          the DOS default colors. Some text mode (non-graphics) programs also
  127.          reset the VGA palette. These programs will also reset your custom
  128.          palette and set DOS default colors when they exit. When you run any
  129.          of these types of programs you can re-establish your custom palette
  130.          (If you have saved it as a COM file) by typing its name at the DOS
  131.          command line or by creating a batch file, or start up Color Commander
  132.          Interactive and load the palette using the F4 function key.
  133.  
  134.          Most text mode programs do not reset the color palette when they
  135.          run so your custom palette will not be zapped. For example the
  136.          Norton Commander is a well behaved program that does not reset
  137.          the palette on entry or exit. A custom palette should work just
  138.          fine for this program.
  139.  
  140.  
  141.  
  142.  
  143.  
  144.          COLOR COMMANDER INTERACTIVE:
  145.          ───────────────────────────
  146.  
  147.          To run Color Commander Interactive, type:
  148.  
  149.          CCI <enter>
  150.  
  151.          Color Commander Interactive will load into memory and you will
  152.          see the following text:
  153.  
  154.          Color Commander Interactive loaded. Press Alt-LeftShift-Z to activate.
  155.  
  156.          Pressing the Alternate, LeftShift and Z key at the same time will
  157.          bring up the Color Commander Interactive pop-up window and a
  158.          blinking  pointer. You can move the pointer around the screen
  159.          using the cursor keys. If the pointer gets too close to the pop-up
  160.          window the pop-up will move to the other side of the screen. Pressing
  161.          the escape key when the pop-up is active will quit Color Commander
  162.          Interactive until you call it again with the Alt-LeftShift-Z key
  163.          combination.
  164.  
  165.          To remove Color Commander Interactive from memory press ALT-U.
  166.          You will hear a <ping-pong> tone to indicate that Color
  167.          Commander was removed successfully. A low tone instead means
  168.          Color Commander Interactive could not safely be removed from
  169.          memory. This usually means that you have loaded other TSR's
  170.          after Color Commander Interactive. The other TSR's will have
  171.          to be removed first.
  172.  
  173.          Always load and unload Color Commander Interactive from the DOS
  174.          command line. Do NOT load or unload it from within a DOS shell or
  175.          while escaped to DOS from within another program.
  176.  
  177.  
  178.  
  179.  
  180.                                       -3-
  181.  
  182.  
  183.          The Pointer  :
  184.          ─────────────
  185.          Color Commander Interactive reads the foreground or background
  186.          color attribute of the character that the pointer points at.
  187.          Pressing the TAB key toggles between foreground and background
  188.          color. When the word 'foreground' is displayed in the pop-up the
  189.          foreground color will be changed when you press any of the RGB keys.
  190.          When the word 'background' is displayed in the pop-up the background
  191.          color will be changed when you press any of the RGB keys.
  192.  
  193.  
  194.          RGB Keys:
  195.          ────────
  196.          These are the keys you use to change the RED/GREEN/BLUE component
  197.          of the color at the pointer.
  198.  
  199.          'Q','W','E' - Increase RED/GREEN/BLUE color component.
  200.          'A','S','D' - Decrease RED/GREEN/BLUE color component.
  201.  
  202.          Pressing the <ESC> key while in a window will abort the function
  203.          and return you to the pop-up. Pressing the <ESC> key while in the
  204.          pop-up will return you to your program. If in doubt hit <ESC>.
  205.  
  206.  
  207.          ─────────────────────────────────────────────────────────────────────
  208.          DEFINITIONS
  209.          ─────────────────────────────────────────────────────────────────────
  210.  
  211.          PALETTE         : The 16 colors that DOS and your programs use.
  212.  
  213.  
  214.          DEFAULT PALETTE : The DOS default colors that are active when your
  215.                            computer first boots up. Color Commander Interactive
  216.                            knows what the default DOS colors are so you can
  217.                            reset the palette to default at any time.
  218.  
  219.  
  220.          ACTIVE PALETTE  : The palette that is displayed at the top part of
  221.                            the screen while in Color Commander Interactive.
  222.  
  223.  
  224.          CURRENT PALETTE : The palette that was active when Color Commander
  225.                            Interactive was run. The current palette is saved
  226.                            internally by Color Commander Interactive at start
  227.                            up.
  228.  
  229.  
  230.          CUSTOM PALETTE  : A palette that you create using Color Commander
  231.                            Interactive.
  232.  
  233.  
  234.          LOAD            : When you load a palette using <F4> it becomes the
  235.                            ACTIVE palette. You can return to the CURRENT
  236.                            palette by pressing the <F6> function key or the
  237.                            DEFAULT palette by pressing <F7>.
  238.  
  239.  
  240.          SAVE            : When you save a palette using <F2>,<F3> the active
  241.                            palette is saved.
  242.  
  243.  
  244.                                       -4-
  245.  
  246.  
  247.  
  248.          ─────────────────────────────────────────────────────────────────────
  249.          KEY FUNCTIONS
  250.          ─────────────────────────────────────────────────────────────────────
  251.  
  252.          <F1>             Help - display summary of commands. Press any key
  253.                           to return to Color Commander Interactive.
  254.  
  255.  
  256.          <F2>             Save palette to disk as path\filename.pal. Can
  257.                           be loaded from disk later and becomes the ACTIVE
  258.                           palette. Press <ESC> or <RETURN> to cancel.
  259.  
  260.  
  261.          <F3>             Save palette to disk as path\filename.com.
  262.                           Cannot be loaded into Color Commander Interactive,
  263.                           but can be executed from the DOS command line.
  264.                           Use this feature to save custom palettes that can
  265.                           be called from batch files. Press <ESC> or <RETURN>
  266.                           to cancel.
  267.  
  268.                           For example if you create a custom palette for use
  269.                           with the Norton Commander called NCPAL.COM and a DOS
  270.                           default palette called DEFAULT.COM., the batch file
  271.                           might look like this:
  272.  
  273.                           @ECHO OFF    rem  Don't echo
  274.                           NCPAL        rem  Set the custom palette colors
  275.                           NC           rem  Call the norton commander
  276.                           DEFAULT      rem  reset colors to DOS defaults
  277.  
  278.  
  279.  
  280.          <F4>             Load a palette from disk. (.PAL). Press <ESC> or
  281.                           <RETURN> to cancel.
  282.  
  283.  
  284.          <F5>             Reset the color at the pointer to the CURRENT
  285.                           palette color.
  286.  
  287.  
  288.          <F6>             Reset all palette colors (0-15) to the CURRENT
  289.                           palette colors. The CURRENT palette becomes the
  290.                           ACTIVE palette.
  291.  
  292.  
  293.          <F7>             Reset all palette colors (0-15) to the DOS DEFAULT
  294.                           colors. The DEFAULT palette becomes the ACTIVE
  295.                           palette.
  296.  
  297.  
  298.          <F8>             Convert the ACTIVE palette to shades of gray.
  299.  
  300.  
  301.          ALT<U>           Unload Color Commander Interactive from memory.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.                                       -5-
  308.  
  309.  
  310.  
  311.          ─────────────────────────────────────────────────────────────────────
  312.          SPECIAL KEYS
  313.          ─────────────────────────────────────────────────────────────────────
  314.  
  315.          LEFT-ARROW          - Move cursor left.
  316.  
  317.          RIGHT-ARROW         - Move cursor right.
  318.  
  319.          UP-ARROW            - Move cursor up.
  320.  
  321.          DN-ARROW            - Move cursor down.
  322.  
  323.          TAB                 - Toggle between foreground and background color.
  324.  
  325.          ESC                 - Exit a window or exit Color Commander
  326.                                Interactive.
  327.  
  328.          PLUS(+)             - Intensity, increases all 3 color values.
  329.  
  330.          MINUS(-)            - Intensity, Decreases all 3 color values.
  331.  
  332.          Q                   - Increase RED color value.
  333.  
  334.          A                   - Decrease RED color value.
  335.  
  336.          W                   - Increase GREEN color value.
  337.  
  338.          S                   - Decrease GREEN color value.
  339.  
  340.          E                   - Increase BLUE color value.
  341.  
  342.          D                   - Decrease BLUE color value.
  343.  
  344.  
  345.  
  346.          ─────────────────────────────────────────────────────────────────────
  347.          KEY LAYOUT - RGB Keys:
  348.          ─────────────────────────────────────────────────────────────────────
  349.  
  350.  
  351.  
  352.  
  353.                             Increase RED───┐ ┌───Increase GREEN
  354.                                            │ │ ┌──Increase BLUE
  355.          Toggle foreground/background──TAB Q W E
  356.                                            A S D
  357.                             Decrease RED───┘ │ └──Decrease BLUE
  358.                                              └───Decrease GREEN
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.                                       -6-
  370.  
  371.  
  372.  
  373.  
  374.          Using Color Commander Interactive:
  375.          ─────────────────────────────────────────────────────────────────────
  376.          Load Color Commander Interactive from the DOS command line, then
  377.          run the program you wish to make a custom palette for. While in
  378.          your program press Alt-LeftShift-Z and the pop-up window will
  379.          appear. Move the pointer around the screen until it points at the
  380.          color (foreground or background) you wish to change. Use the RGB
  381.          keys to change the color. You can reset a color you have changed
  382.          by pointing to it and pressing the F5 function key. Or reset
  383.          all colors you have changed by pressing the F6 function key.
  384.  
  385.  
  386.          You may want to start with a gray palette and add just a few
  387.          colors at a time. Pressing function key F8 converts the active
  388.          palette to shades of gray with intensity values equal to that
  389.          of the color palette. Pressing F6 reverts back to the previously
  390.          active color palette.
  391.  
  392.  
  393.          To save a custom palette to disk press F2 and type in the
  394.          palette file name to save. The palette will be saved to disk in
  395.          the current directory as filename.pal. Pressing F3 (REGISTERED
  396.          users only) will save the palette as filename.com.
  397.  
  398.  
  399.          To load a palette file from disk press F4. You must be in
  400.          the directory that contains the palette files or you will get an
  401.          error message 'Unable to open filename.pal'.
  402.  
  403.  
  404.  
  405.          NORTON UTILITIES:
  406.          ─────────────────────────────────────────────────────────────────────
  407.          The Norton Utilities turn off the blink bit and use foreground
  408.          colors for background colors. The Color Commander Interactive
  409.          pointer will not blink in this program. The window border
  410.          characters get a little scrambled also. I have tested many TSR's
  411.          with The Norton Utilities and they all have scrambled window borders.
  412.          Reason unknown? However, Color Commander Interactive works just
  413.          fine inside of The Norton Utilities and you can create a custom
  414.          palette for this program if you wish to.
  415.  
  416.  
  417.          UTILITIES AND PALETTE FILES:
  418.          ─────────────────────────────────────────────────────────────────────
  419.          I have included several PAL and COM files to give you a better idea
  420.          of what you can do with Color Commander Interactive. DEFAULT.COM is
  421.          the DOS standard (default) color palette. These are the colors that
  422.          DOS sets when your system boots up.
  423.  
  424.          Also included is a small utility called SHOPAL.EXE. It will show you
  425.          the colors of the active palette from the DOS command line.
  426.  
  427.  
  428.                                       -7-
  429.  
  430.  
  431.          NOTE:
  432.          ────
  433.          When creating a custom palette for a program it may be best to start
  434.          out with a gray palette (F8 - Convert2Gray). Add one or two colors
  435.          at a time. Too much color is confusing. You will be surprised at how
  436.          good many programs look with a lot of grays and just a few colors.
  437.  
  438.  
  439.          REGISTERED VERSION:
  440.          ─────────────────────────────────────────────────────────────────────
  441.          The registered version of Color Commander Interactive allows you to
  442.          save palette files as .COM executables. also included are two
  443.          utilities that allow you to save and restore the current palette
  444.          from the DOS command line or a batch file. Plus.... many custom
  445.          palette files.
  446.  
  447.  
  448.          OTHER PROGRAMS:
  449.          ─────────────────────────────────────────────────────────────────────
  450.          Color Commander (CCMDR.ZIP) - A non TSR version of Color Commander
  451.          interactive. Resident palettes, pick-lists, pop-up windows, ASCII
  452.          chart, color chart and more!
  453.  
  454.          CCMDR-I.ZIP contains COLOR COMMANDER and COLOR COMMANDER INTERACTIVE.
  455.          You can now register both programs for $25.00. See file REG.TXT for
  456.          details.
  457.  
  458.          Author: Mike Laszko
  459.  
  460.          Modem : 1-619-728-7307
  461.  
  462.          Fax   : 1-619-728-0264
  463.  
  464.          Mail  : Data Management Systems
  465.                  P.O. Box 2828
  466.                  Fallbrook, Ca. 92088-2828
  467.  
  468.  
  469.          The current version of Color Commander and Color Commander
  470.          Interactive are available for download from:
  471.  
  472.          THE FILE BANK BBS
  473.          1-619-728-7307
  474.          1200-115,200 baud
  475.          USR 28.8 HST DS v.34
  476.  
  477.  
  478.          Note from the author:
  479.  
  480.          Comments and suggestions are always welcome. I can be reached
  481.          on the File Bank BBS. Thank you for trying Color Commander
  482.          Interactive.
  483.  
  484.                                       -8-
  485.  
  486.